home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbrbuf.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.2 KB  |  38 lines
  1. .Na "DBRBUF    (UNIX only)"
  2. .Aa
  3. .Fu
  4. Determine whether the \*L network buffer contains
  5. any unread bytes.
  6. .Ih "network buffer, determining whether it contains unread bytes (UNIX)"
  7. .Sy
  8. .Sf "DBBOOL DBRBUF(dbproc)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Co
  11. .Bl
  12. This routine lets the application know if the \*L
  13. network buffer contains any bytes yet unread.
  14. .Bl
  15. \f2DBRBUF()\f1 is ordinarily used in conjunction with 
  16. \f2dbsqlok()\f1 and \f2DBIORDESC()\f1 to manage multiple input data streams.
  17. .Ih "input streams, multiple"
  18. To manage these input streams efficiently,
  19. an application that uses \f2dbsqlok()\f1 should check whether any bytes 
  20. remain either in the network buffer (by calling \f2DBRBUF()\f1) or in the network itself
  21. (by calling the UNIX \f2select()\f1) before it calls \f2dbresults()\f1.
  22. See the \f2\*L Reference Supplement\f1 for an example of this.
  23. .Bz
  24. .Pa
  25. .Pi dbproc
  26. A pointer to the DBPROCESS structure that provides the connection
  27. for a particular front-end/\*S process.  It contains all the
  28. information that \*L uses to manage communications and data between the
  29. front end and \*S.
  30. .in -.375i
  31. .Re
  32. .br
  33. TRUE (bytes remain in buffer) or FALSE (no bytes in buffer).
  34. .Sa
  35. DBIORDESC,
  36. dbsqlok,
  37. dbresults
  38.